Contexto global

GetForm

Sintaxis:

GetForm(<NombreFormulario>, <Parámetros>, <Propietario>, <Único>, <Ventana>, <EnlaceNavegación>)

Parámetros:

Tipo: Cadena.
Nombre del formulario. Generado como una ruta completa al objeto de metadatos del formulario (por ejemplo, “Catalog.Counterparties.Form.ObjectForm” o “CommonForm.SaveFileForm”) o como una ruta completa a un objeto aplicado con el nombre de formulario predeterminado (por ejemplo, “Catalog.Goods.ChoiceForm”).
Nombres de formulario predeterminados:

• ObjectForm. Formulario de objeto predeterminado.
• FolderForm. Formulario de carpeta predeterminado.
• RecordForm. Formulario de registro de registro predeterminado.
• ListForm. Formulario de lista predeterminado.
• ChoiceForm. Formulario de selección predeterminado.
• FolderChoiceForm. Formulario de selección de carpeta predeterminado.
• ConstantsForm. Formulario de constante predeterminado para el modo normal establecido como formulario de constante para la configuración.
• Form. Formulario predeterminado de constante, informe o procesador de datos.
• CommonForm. Formulario común predeterminado.
• SettingsForm. Formulario de configuración de informe predeterminado.
• LoadForm. Formulario para cargar configuraciones.
• SaveForm. Formulario para guardar configuraciones.
• VariantForm. Formulario para editar opciones de informe.
• ReportUserSettingsLoadForm. Formulario para cargar configuraciones de informe.
• ReportUserSettingsSaveForm. Formulario para guardar configuraciones de informe.
• ReportVariantsLoadForm. Formulario para cargar opciones de informe.
• ReportVariantsSaveForm. Formulario para guardar opciones de informe.
• FormDataSettingsLoadForm. Formulario para cargar configuraciones de datos de formulario.
• FormDataSettingsSaveForm. Formulario para guardar configuraciones de datos de formulario.
• SearchForm. Formulario de búsqueda de datos de texto completo.
• DataHistoryChangeHistoryForm. Formulario de historial de cambios que muestra una lista de versiones de datos. Para los parámetros, consulte Formulario del sistema para el historial de modificaciones de historial de datos.
• DataHistoryVersionDataForm. Formulario de datos de versión que muestra el informe “Datos de versión”. Para los parámetros, consulte Formulario del sistema para la versión de historial de datos.
• DataHistoryVersionDifferencesForm. Formulario con diferencias en versiones de historial de datos que muestra el informe “Diferencias entre versiones”. Para los parámetros, consulte Formulario del sistema para las diferencias de versión de historial de datos.

Por ejemplo, para obtener el formulario común CommonSettings, escriba el siguiente código en el módulo:

Para informes externos y procesadores de datos, especifique un nombre de formulario de la siguiente manera:

• ExternalReport.<nombre informe>.Form.<nombre formulario>
• ExternalReport.<nombre informe>.<nombre formulario estándar>
• ExternalDataProcessor.<nombre procesador datos>.Form.<nombre formulario>
• ExternalDataProcessor.<nombre procesador datos>.<nombre formulario estándar>

Un informe externo o procesador de datos debe estar registrado en la aplicación antes de llamar a este método.

Tipo: Estructura.
Parámetros del formulario. La clave de la estructura es el nombre del parámetro y el valor es el valor del parámetro del formulario. El nombre del elemento debe ser el mismo que el nombre del parámetro de la estructura.

Propietario del formulario. Esto puede ser un formulario o el control de otro formulario.

Tipo: Arbitrario.
Este parámetro se puede utilizar para establecer una clave con un valor que se utilizará para buscar formularios que ya se hayan abierto. Si un formulario tiene la misma clave de unicidad, se activará el formulario encontrado en lugar de abrir un nuevo formulario.
Si el valor es Falso, el sistema buscará un formulario con una clave de unicidad predeterminada, y si el valor es Verdadero, no se buscará un formulario. Cualquier otro valor especifica la clave de unicidad en la que se realizará la búsqueda.
Valor predeterminado: Falso.

Tipo: VentanaAplicaciónCliente.
La ventana de la aplicación en la que se abre el formulario.
Solo aplicable para un formulario de aplicación cliente. Solo se puede establecer una ventana de aplicación principal o una ventana de formulario auxiliar como ventana.

Tipo: Cadena, Indefinido.
Si contiene un valor diferente de Indefinido, entonces la propiedad URL se establece en este valor para el formulario obtenido como resultado de la llamada a este método y la propiedad AutoURL de este formulario se establece en Falso.
Valor predeterminado: Indefinido.

Valor devuelto:

Tipo: Formulario, FormularioAplicaciónCliente, Indefinido.
Indefinido – si se establece la bandera que fuerza a cancelar la creación del formulario en el controlador OnCreateAtServer.

Descripción:

Obtiene un formulario o un formulario de aplicación cliente. Antes de obtener un formulario, el método verifica si el formulario ya está abierto buscando en los formularios abiertos.
La búsqueda se basa en el tipo de formulario, los valores de los campos clave, el propietario y la clave de unicidad.
Si el parámetro <Unicidad> se establece en Verdadero, se omite la búsqueda.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).
La llamada al método ejecuta una llamada al servidor.

Nota:

En los clientes ligero y web, solo se obtienen formularios de aplicación cliente.
No se admiten formularios ordinarios de procesadores de datos externos.
Cuando se obtiene un formulario ordinario, si el parámetro <NombreFormulario> no contiene un nombre de formulario predefinido, se ignoran los parámetros pasados.
Indefinido si el parámetro <Cancelar> del controlador OnCreateAtServer se establece en Verdadero.
ValueToFormAttribute

Véase también:

Contexto global, método OpenForm
Contexto global, método OpenFormModal
Contexto global, método GetCommonForm

Disponible desde:

Disponible desde la versión 8.2.

Descripción cambiada en la versión 8.3.21.